home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / pascal / xlibpas2.zip / README.DOC < prev    next >
Text File  |  1994-06-12  |  9KB  |  170 lines
  1. ╔═══════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                           ║
  3. ║        XLIB v2.0 - Graphics Library for Borland/Turbo Pascal 7.0          ║
  4. ║                                                                           ║
  5. ║               Tristan Tarrant - tristant@cogs.susx.ac.uk                  ║
  6. ║                                                                           ║
  7. ╠═══════════════════════════════════════════════════════════════════════════╣
  8. ║                                                                           ║
  9. ║                                 Credits                                   ║
  10. ║                                                                           ║
  11. ║                             Themie Gouthas                                ║
  12. ║                                                                           ║
  13. ║                            Matthew MacKenzie                              ║
  14. ║                                                                           ║
  15. ║                             Tore Bastiansen                               ║
  16. ║                                                                           ║
  17. ║                                 Andy Tam                                  ║
  18. ║                                                                           ║
  19. ║                               Douglas Webb                                ║
  20. ║                                                                           ║
  21. ║                              John  Schlagel                               ║
  22. ║                                                                           ║
  23. ╠═══════════════════════════════════════════════════════════════════════════╣
  24. ║                                                                           ║
  25. ║           I informally reserve all rights to the code in XLIB             ║
  26. ║       Rights to contributed code is also assumed to be reserved by        ║
  27. ║                          the original authors.                            ║
  28. ║                                                                           ║
  29. ╚═══════════════════════════════════════════════════════════════════════════╝
  30.  
  31. ╔═══════════════════════════════════════════════════════════════════════════╗
  32. ║ DISCLAIMER                                                                ║
  33. ╚═══════════════════════════════════════════════════════════════════════════╝
  34.  
  35.   This library is distributed AS IS. The author/s specifically disclaim any
  36.   responsibility for any loss of profit or any incidental, consequential or
  37.   other damages.
  38.  
  39. ╔═══════════════════════════════════════════════════════════════════════════╗
  40. ║ IMPORTANT NOTICE                                                          ║
  41. ╚═══════════════════════════════════════════════════════════════════════════╝
  42.  
  43.   Hi Xlib users, this is v2.0 of my port of XLib to Turbo/Borland Pascal.
  44.   I would like to state a few things before you start using this package :
  45.   
  46.   XLIB 2.0 is NOT complete. I would have liked to add more things before
  47.   releasing this, but the end of my 2nd year here at Sussex University is
  48.   coming to an end, and I'm in the middle of my exams. Then I will go home
  49.   to Italy, and won't have Internet access until I come back in October.
  50.   
  51.   I wanted to get this finished, including rotation and the such, but, alas,
  52.   I haven't found the time. In line with these considerations I want you to
  53.   think this as a BETA.
  54.  
  55.   I have ported all the useful stuff from Xlib for C v6.0, and added a few
  56.   things of my own, apart from cleaning up the code and making it more
  57.   Pascal-friendly.
  58.  
  59.   If there is any code you have written that you think is worth including in
  60.   the next release, don't hesitate to send it to me and you will receive due
  61.   credit.
  62.  
  63.   Sorry if this isn't up to your expectations but, hey, don't forget : XLIB
  64.   is a user supported library, so send me your code and let's write the
  65.   ultimate XMode game !!!
  66.  
  67.   Share and enjoy.
  68.  
  69. ╔═══════════════════════════════════════════════════════════════════════════╗
  70. ║ BUGS AND REVISIONS                                                        ║
  71. ╚═══════════════════════════════════════════════════════════════════════════╝
  72.     
  73.   The SplitScreen routines weren't handled by the Virtual VSync Handler, 
  74.   sometime resulting in the program waiting twice for a vsync, and causing
  75.   a choppy effect when scrolling the split screen.
  76.   Now the mouse handler uses the VVSH to redraw the pointer when necessary. 
  77.   Unfortunately it takes a bit too long and, if you are updating the whole 
  78.   palette AND using the mouse at the same time, you'll notice that the tip 
  79.   of the pointer disappears for an instant when it's at the top of the screen.
  80.   The palette-updating part of the VVSH has been sped up a bit.
  81.  
  82.   I have implemented 32-bit compiled bitmaps, even though they are bigger and
  83.   (on my machine) slightly slower than normal CBMs. Maybe on VLB/PCI machines
  84.   this isn't the case.
  85.  
  86.   Protected mode is still at an experimental stage, but it can do quite a few
  87.   things already.
  88.   Things that don't work in protected mode are :
  89.  
  90.   - The Virtual VSync Handler (self-modification works, but the rest doesn't)
  91.   - CBMs (attempting to execute data...)
  92.   - VBM's on my machine are faster in pmode (??!?!?!)
  93.   - I assume that the ROM font is at segment 0C000h because that's where the
  94.       Video BIOS usually is. I have tested it on a Paradise (WD90c30), a
  95.       Cirrus Logic (CL-54xx) and a Trident (9000i) with no problems. If you
  96.       find some board that doesn't work please report it (though I don't know
  97.       why you'd want to use ROM BIOS fonts anyway :-)
  98.   - The palette scrolling in XLIBDEMO is tooooooo slow...
  99.  
  100.   If you find a way of fixing these, or if you find more routines that don't
  101.   like protected mode, email me please.
  102.  
  103. ╔═══════════════════════════════════════════════════════════════════════════╗
  104. ║ NOTES                                                                     ║
  105. ╚═══════════════════════════════════════════════════════════════════════════╝
  106.  
  107.   A good idea for debugging programs that use XLib is to use Colin Buckley's
  108.   UNCHAIN v2.1 program. The code for saving the screen information is built
  109.   in the xsetmode function, but if you don't use UNCHAIN it should not make
  110.   any difference.
  111.   I noticed that UNCHAIN doesn't work when debugging a DPMI program in TDX.
  112.  
  113. ╔═══════════════════════════════════════════════════════════════════════════╗
  114. ║ APPLICATIONS THAT USE XLIB FOR TP/BP                                      ║
  115. ╚═══════════════════════════════════════════════════════════════════════════╝
  116.  
  117.   I have decided to start a list of applications that have been written using 
  118.   a version of XLibPas, and where they can be found. Please mail me any 
  119.   additions.
  120.  
  121.  
  122.   Chromatiks - The world's first multi-group music disk. Coordinated by
  123.     Trixter (Jim Leonard).
  124.  
  125.       Site      : wasp.eng.ufl.edu
  126.       Directory : /pub/msdos/demos/music/disks
  127.       Filename  : chromat*.zip
  128.  
  129.   WadManager v1.11b - A GUI WAD manager for DOOM. Written by Tristan Tarrant.
  130.  
  131.       Site      : infant2.sphs.indiana.edu
  132.       Directory : /pub/doom/misc
  133.       Filename  : wm111b.zip
  134.  
  135. ╔═══════════════════════════════════════════════════════════════════════════╗
  136. ║ CREDITS AND THANKS                                                        ║
  137. ╚═══════════════════════════════════════════════════════════════════════════╝
  138.  
  139.     Michael Abrash - The guy who started it all in the first place
  140.  
  141.     Themie Gouthas - The original maintainer of the XLIB for C library
  142.  
  143.     Matthew McKenzie - Compiled blits, circles and clipping. What more could
  144.       I say
  145.  
  146.     Tore Bastiansen - For the Virtual VSync handler : a masterpiece of coding
  147.  
  148.     Andy Tam - For the LZS encoding/decoding routines
  149.  
  150.     Douglas Webb - For collecting loads of compression algorithms
  151.  
  152.     John Schlagel - For the bitmap scaling code
  153.  
  154.     iD Software - For giving me inspiration for XLAs
  155.  
  156.     Jim